This page last changed on Nov 29, 2008.

Building Library Data Services

This topic introduces you to library data services.

Overview

Data services enable you to combine multiple data sources of different types into service-oriented architectures. There are two types of data services:

  • Entity data services
  • Library data services

Entity data services enable you to design, model, and create a data view from multiple underlying data sources including relational databases, web services, XML files, other files, and Java functions.

Library data services, on the other hand, are simply a collection of related functions and procedures within a data service container. More formally, a library data service is an Oracle Data Service Integrator dataspace container for data management operations.

Library data services can be user-defined or they can be an automatic collection of functions originating from certain kinds of physical sources in the form of annotated collections of XQuery functions.

Library data services have the following characteristics:

  • They contain library functions and procedures
  • They can contain custom native database functions
  • They do not contain create, retrieve, update, delete, or navigate procedures
  • They have no associated XML Type (schema) element
  • They have no relationship with other library or entity data services
    Library data services that contain native database functions are limited to those types of functions.
     
    Library data services are ideal for creating sharable transformation, security, and other types of functions, and can be used by any other library or entity data service. Functionally, a library data service is expressed in a single XML file.

Library Data Service Views

Workshop for WebLogic provides the following views for library data services:

Overview

Overview displays the functions and procedures declared in the library data service. Clicking an entry in the overview displays the following:

  • For functions, Workshop for WebLogic displays the query map for the function
  • For procedures, Workshop for WebLogic displays the source code for the procedure 
Library Data Service Overview

You can add a new function or procedure by right-clicking in the background and choosing Add Operation.

How to Add a Library Function or Procedure

Query Map

The Query Map graphically displays the parameters and return value of the selected function.

Library Data Service Query Map

Plan

The Plan view enables you to display the query execution plan for a function, enabling you to identify potential performance and memory problems.

Test

The Test view enables you to test any function or procedure in the data service before you build a custom client. Testing a function, for example, returns data as the service would to a client, in the shape of the return type.

Library Data Service Test View

Source

The Source view enables you to display and directly edit the source code for XQuery functions and procedures in the data service.

Library Data Service Source View

See Also

Concepts
How Tos

Document generated by Confluence on Jan 13, 2009 15:57